home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / grafix / tools / iff_to_ascii / iff_to_ascii.doc < prev    next >
Encoding:
Text File  |  1996-02-26  |  10.3 KB  |  255 lines
  1.     aµ,,µµµµµraµµµµµ       __                µµ     aææw    _ææµ  ,µ,jµw 
  2.     0ØF7ØØØØØL0ØØØØØÞ     JØF               JØØ    dØØØØ#  µØØØØK 7Ø1JØ# 
  3.     0ØF7Ø@@@@L0Ø@@@@      jØF_   _          ØØØL   Øد¬Ø#  ØØP¶ØØ 7Ø1JØ# 
  4.     0ØF7Ø1    0ØF         ØØØF ,ÆØ#_        ØØØ#   ØØw_   7Ø#  ¶Ñ¹7Ø1JØ# 
  5.     0ØF7Ø&µµw 0Ø&µµ,      ¶Ø@¹ ØØ@Ø#       JØ@ØØ   ¶ØØØm_ 0ØF     7Ø1JØ# 
  6.     0ØF7ØØØØ# 0ØØØØ1      JØF JØF ¶Ø       ÆØF¶ØL   ¶ØØØ# 0ØF     7Ø1JØ# 
  7.     0ØF7Ø@@@4 0Ø@@@²      JØF 7ØL JØL      ØØ_JØQ    ¬¶ØØÞ¶ØQ  ,µ,7Ø1JØ# 
  8.     0ØF7Ø1    0ØF         JØF ¶ØL JØÞ     JØØØØØ#  ÑÑ  ØØLJØ#_ ÆØF7Ø1JØ# 
  9.     0ØF7Ø1    0ØF         JØÑr¬Ø#µØØ      áØØÑÑ#ØÞ #ØÑMØØ  0ØØØØØ 7Ø1JØ# 
  10.     0ØF7Ø1    0ØF         ¬#ØL ¶ØØØ"      ØØ   ¶ØE ¬#ØØØF  ¬#ØØØ" 7Ø1JØ# 
  11.     ¬"~¬""    ¬"~           "   ¬"        ""   ¬""   ""¯     ""   ¬""¬""
  12.  
  13.                            (c) 1996 John Hawkins
  14.  
  15.                                 Introduction
  16.                                 -=-=-=-=-=-=
  17.  
  18. The logo says it all really. IFF to ASCII is a simple program that converts
  19. IFF pictures into text files, so you can create that group logo or stunning
  20. piece of ASCII art you've always wanted.
  21.  
  22.  
  23.                             Copyright conditions
  24.                             -=-=-=-=-=-=-=-=-=-=
  25.  
  26. This program is copyrighted by John Hawkins of HaVoC software. It may be
  27. freely distributed as long as the following conditions are met:
  28.  
  29. 1> This document file is always included in ANY distribution. I would prefer
  30. if you could include the examples files, but this is not essential.
  31.  
  32. 2> The product is not sold for any more than standard PD prices, with the
  33. exception of special compilations such as CDs or magazine coverdisks.
  34.  
  35. 3> If you like it, a donation of £5 to the address below would be really
  36. appreciated (see below for more details).
  37.  
  38. 4> There is NO condition number 4.
  39.  
  40.  
  41.                               Getting started
  42.                               -=-=-=-=-=-=-=-
  43.  
  44. If you're going to convert a picture into text, you're fairly obviously
  45. going to need a picture first. This is very straightforward. I use Dpaint,
  46. but any iff-outputting package will do.
  47.  
  48. Draw your picture in hires (640x256 or 640x200) and in 2 colours.
  49.  
  50. This is very important. If the screen size is wrong, the program will just
  51. fit it in the best it can, but if you use any more colours than 2 you're
  52. heading for a disaster.
  53.  
  54. So, you've got your 640x200/256 2 colour masterpiece. Save it to disc.
  55.  
  56. Now, load up the program. You can either do this from workbench by
  57. double-clicking on the icon, or from the CLI, whichever you prefer.
  58.  
  59. Upon loading the program you are presented with an information screen. click
  60. a mouse button to proceed. You're now into the main program. notice that you
  61. have a purple control panel (refered to as the control panel) on top of a
  62. blank screen (refered to as the processing area).
  63.  
  64.  
  65.                              The main program
  66.                              -=-=-=-=-=-=-=-=
  67.  
  68. To be honest, it's very straightforward generating your ASCII pics. The
  69. process can be broken down into a number of very simple steps:
  70.  
  71. -Load in IFF picture
  72.  
  73. -Select character set (optional)
  74.  
  75. -Select portion of picture to convert (optional)
  76.  
  77. -Convert it
  78.  
  79. -Save the ASCII file
  80.  
  81.  
  82.                         Loading in your IFF picture
  83.                         -=-=-=-=-=-=-=-=-=-=-=-=-=-
  84.  
  85. This is very simple. On the control panel, click on Load IFF. A file
  86. requester will now appear, from which you should select the IFF file you
  87. want to convert. Remember it should be 640x256/200 and in 2 colours. Click
  88. Ok, and the picture will be loaded into the processing area.
  89.  
  90.  
  91.                          Selecting a character set
  92.                          -=-=-=-=-=-=-=-=-=-=-=-=-
  93.  
  94. This is an optional part of the process, so you can completely ignore it if
  95. you wish.
  96. This part allows you to determine which characters will be used to make up
  97. your ASCII picture. You have a choice between letters, most and all- all
  98. being the default.
  99.  
  100. If letters is selected, your picture will only be made up from upper and
  101. lower case letters and no other characters.
  102. If most is selected, your picture will be made up from all characters up to
  103. character 128 in the amiga ASCII set, thus giving more compatability with
  104. other ASCII sets.
  105. If all is selected, all applicable characters in the amiga ascii set will be
  106. used. This is the best to use when the result is only going to be shown on
  107. the amiga, although may be a little slower than the other two to generate,
  108. and wierd results could occur if you view it on other machines with other
  109. ascii sets.
  110.  
  111. In order to change the character set, merely click on the cycle gadget in
  112. the bottom left hand corner of the control panel (underneath the words
  113. 'character set:'). The one that will be used is the one displayed.
  114.  
  115.  
  116.                 Selecting a portion of the screen to convert
  117.                 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  118.  
  119. This again is optional: if you want to convert the entire picture, then go
  120. straight on to the next stage.
  121.  
  122. Note that on the control panel you are given the width and height in
  123. characters that will currently be used. The defaults are a width of 80 and a
  124. height of 32- i.e. 80 columns and 32 rows. Be aware that although a hires
  125. screen can fit 80 characters across it, a lot of text viewers and editors
  126. have borders and scrollbars limiting you to 78 or 79 characters across.
  127.  
  128. If you only want to convert some of the picture, the process is very simple.
  129. First, click on the '<-Set' button on the control panel. The control panel
  130. will now dissapear, exposing the whole picture. You need to click and drag a
  131. rectangle which holds the area you want to convert. To do this, first click
  132. anywhere on the screen. Then, without letting go of the left button, move
  133. the mouse until the correct rectangle is displayed, then let go of the left
  134. button. The control panel will now re-appear, and your new width and height
  135. will be displayed.
  136.  
  137.  
  138.                               Converting it
  139.                               -=-=-=-=-=-=-
  140.  
  141. Now, the important bit. Once you're all set up by the previous three stages,
  142. simply click on the 'GO!' button on the control panel and you're away.
  143.  
  144. In the processing area, you can see very clearly the program's progress, as
  145. when each new character is generated, it is printed over the area of screen
  146. it represents. There is also a progress bar on the right hand side of the
  147. control panel- the more white it is, the more the program has got done.
  148.  
  149. Note also on the right hand side of the control panel the word match. The
  150. percentage to the right of this signifies how close the last letter
  151. generated was to the block it represented. A 100% match will only usually be
  152. achieved by blocks of blank space.
  153.  
  154. When the conversion has finished, the iff picture will be removed, and your
  155. piece of ascii art will be displayed in the processing area in it's full
  156. glory. A report window will also display, giving details about the
  157. conversion. Note that these values could be a bit wrong if you aborted
  158. early. When you've finished reading the report window, click a mouse button
  159. to return to the control panel.
  160.  
  161. If at any time you want to abort, click on, and hold down the 'Stop' button
  162. on the control panel (don't let go of the mouse until the report window
  163. displays).
  164.  
  165.  
  166.                          Saving the ASCII file
  167.                          -=-=-=-=-=-=-=-=-=-=-
  168.  
  169. To finish off, you need to save the result. To do this, click on Save ASCII
  170. on the control panel. A file requester appears in which you should specify
  171. the name of your new ASCII masterpiece.
  172.  
  173. And that's it- it's as easy as anything.
  174.  
  175.  
  176.                              Other buttons
  177.                              -=-=-=-=-=-=-
  178.  
  179. There are two other buttons on the control panel that are as yet
  180. unexplained, but also very self-explanatory.
  181.  
  182. About reproduces the about screen that appears at the start of the program.
  183.  
  184. Quit, surprisingly enough, quits the program.
  185.  
  186.  
  187.                              Hints and tips
  188.                              -=-=-=-=-=-=-=
  189.  
  190. There are several things you can try in order to get better results:
  191.  
  192. -Remember that you can always tweak your ascii file in a text editor
  193. afterwards, such as spacing bits out and changing characters around. So
  194. always leave a bit of space at the right hand edge of your picture.
  195.  
  196. -If you want to convert a picture of more than 2 colours or a different
  197. resolution, programs like dpaint can very effectively change screen formats,
  198. as well as doing the necessary dithering. It may be worth a try.
  199.  
  200. -Clear shapes with lots of space around probably convert most accurately,
  201. but you may well get interesting effects from less clear pictures, so give
  202. them a try.
  203.  
  204. -The easiest way to create an ASCII logo is to write it out in a very big
  205. font in a paint package, then convert it. The logo at the top of this file
  206. was done in this manner- using a pd font called cswiss, which was drawn in
  207. 102 point size. The bigger the font the better the result.
  208.  
  209. -Experimentation is probably the key to success.
  210.  
  211.  
  212.                          Feedback and donations
  213.                          -=-=-=-=-=-=-=-=-=-=-=
  214.  
  215. If you like this program I would really appreciate a donation. If you can
  216. send me a donation of £5 I will send you the Amospro source code on a disk
  217. with some other goodies.
  218.  
  219. Otherwise, please feel free to contact me for any reason: comments, ideas,
  220. suggestions, bug reports, pleas for help, queries or anything. Also if you
  221. have created any particularly good Ascii art with this program I would be
  222. very pleased to see it.
  223.  
  224. Snail-mail:   John Hawkins,
  225.               29, Shields, Crescent,
  226.               Castle Donington,
  227.               Derby,
  228.               DE74 2JS.
  229.  
  230. E-mail:       ssu95jh1@reading.ac.uk
  231.  
  232. web:          http://www.reading.ac.uk/~ssu95jh1/
  233.               (I've got an amiga page on my site, too!)
  234.  
  235.  
  236.                             Current projects
  237.                             -=-=-=-=-=-=-=-=
  238. Multimedia engine
  239. -=-=-=-=-=-=-=-=-
  240. No fixed title as yet. A multimedia program along the lines of hyperbook et
  241. al. Hopefully to be released as licenceware. It's absolutely massive. Don't
  242. miss it. Should be released before easter 96.
  243.  
  244. Operative
  245. -=-=-=-=-
  246. A futuristic 1st person perspective dungeon-master style game. 1 or 2
  247. players. It's going to be an epic. Again, possibly licenceware, and should
  248. be released before easter 96.
  249.  
  250. Havoc rainbows
  251. -=-=-=-=-=-=-=
  252. Just finished. Available on my web site, and wherever else I can get it to.
  253. It's basically a rainbow designer for Amos pro. What more can you say?
  254.  
  255.